home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xarchie-2.0.9 / FWF / FileChooser / README < prev   
Text File  |  1995-06-18  |  3KB  |  63 lines
  1.             README for FileChooser
  2.                    
  3.                George Ferguson
  4.               ferguson@cs.rochester.edu
  5.                    
  6.                Last Change: 28 Jan 1993
  7.  
  8.  
  9. Description
  10.  
  11.     This file documents the FileChooser widget, which provides an
  12.     interface like that shown below (in ASCII) for selecting a file from a
  13.     directory:
  14.  
  15.         +==================================+
  16.         |+--------------------------------+|
  17.         ||     /parent/parent/dir         ||
  18.         |+--------------------------------+|
  19.         ||# File1                         ||
  20.         ||# File2                         ||
  21.         ||# Subdir/                       ||
  22.         ||# File3                         ||
  23.         ||#                               ||
  24.         |+--------------------------------+|
  25.         +==================================+
  26.  
  27.     The top component is a MenuButton that, when clicked on, presents a
  28.     menu of the ancestor directories of the current directory. The bottom
  29.     component is List that presents the contents of the current directory.
  30.     The FileChooser widget's callbacks are called whenever the selection
  31.     changes. Selecting a subdirectory causes its contents to be displayed.
  32.  
  33.     This widget is meant to function within, say, a Form, which would
  34.     provide buttons and perhaps a Text item for entering new filenames.
  35.     The test program FChooserT.c illustrates such usage.
  36.  
  37.     Use of the FileChooser widget requires the Dir package from the
  38.     Free Widget Foundation (free-widgets-request@kazoo.cs.uiuc.edu).
  39.  
  40. Implementation Notes
  41.  
  42.     FileChooser is based on the FileSelector widget by Brian Totty
  43.     (totty@cs.uiuc.edu). The major differences are as follows:
  44.     - FileChooser does not provide any buttons or Text widgets,
  45.       just the directory menu and list of files. Thus it is meant
  46.       to be used within a larger application, for example, to
  47.       allow new filenames to be entered. Because of this, it does
  48.       not enforce any particular policy regarding selections.
  49.     - FileChooser uses a MenuButton and a dynamically generated
  50.       SimpleMenu to present the ancestor directories, similar to
  51.       the Macintosh (tm) interface. This results in about a 50%
  52.       saving in screen real estate.
  53.  
  54.     FileChooser attempts to resize its children whenever it is
  55.     resized. It makes both the MenuButton and the List as wide as the
  56.     FileChooser, and makes the List occupy the entire bottom of the
  57.     FileChooser (with a small gap below the MenuButton). The string
  58.     being displayed in the MenuButton (the current directory) is
  59.     adjusted if it is too long to fit in the given width: it is
  60.     right-aligned, with a "<" at the left edge to indicate truncation.
  61.     It would be nice if the "justify" resource of the MenuButton
  62.     looked after this, but c'est la vie.
  63.